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1 .NET Software Development Kit Overview 


This software development kit (SDK) is intended to provide software and Internet 
developers with the ability to integrate postage rate information into programs and/or 
websites. 


1.1 Licenses and Liability 


The information and components contained within this SDK may be distributed only to 
individuals who have signed the USPS User License and may only be used in accordance 
with the terms of the USPS User License. The USPS assumes no liability forthe incorrect 
implementation of this SDK once it has beenincorporated into a client product. The 
USPS will supply upgrades to the data and/or the objects when needed, but it assumes 
no part in distribution of these upgrades once the engine has beenintegrated into client 
products. 


1.2 Purpose 


This document isto be used as a supplement to NET Software Development Kit 
documentation for the Domestic Business Rate Engines, International Business Rate 
Engines. These documents are titled as following: 


e NET Software Development Kit (SDK): Developing Applications Using the USPS 
Domestic Business Rate Engine 

e NET Software Development Kit (SDK): Developing Applications Using the USPS 
International Business Rate Engine 


1.3 Contact Information 


For Technical Support, contact: 
Email: RCalcPEPMOSupport@usps.gov 


For USPS Support, contact USPS: 
Email: PostalExplorer@usps.com 


2 Application Programming Interface (API) 
2.1 BusinessMailProperties Class 


2.1.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.1.2 Base Class 
ManTech.Usps.RateEngine.Entity.MailProperties 


2.1.3 Constructors 


public BusinessMailProperties() 


2.1.4 Properties 


Name Type Description 

CalculatorElements CalculatorElementsCollection | Gets a reference to a 
collection of calculator 
elements. 


CalculatorFeeElements | CalculatorElementsCollection | Gets a reference to a 
collection of calculator fee 
elements. 


CalculatorlD CalculatorlD Gets or setsthe calculator 
ID. 


decimal Gets and sets the cubic feet. 











DimensionalPounds decimal Gets and sets the 
dimensional weightin 
pounds. 

DiscountsAndSurcharges | DiscountsAndSurcharge Gets a referenceto a 

Collection collection of discounts and 
surcharges. 

ExtraServiceElements ExtraServiceElementCollection | Gets a reference toa 


collection of extra service 
elements. 


2.2 Calculator Class 


2.2.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.2.2 Base Class 


None 


2.2.3 Properties 


Description 
CalculatorElementColumns CalculatorElementColumn Gets or setsa 
Collection referencetoa 
collection of element 
columns objects. 
CalculatorElements CalculatorElement Gets or setsa 
Collection referencetoa 
collection of element 
objects. 
CalculatorFeeElementColumns | CalculatorElementColumn Gets or setsa 
Collection reference toa 
collection of fee 
element columns 
objects. 
CalculatorFeeElements CalculatorElement Gets or setsa 
Collection referencetoa 


collection of fee 


element objects. 


CalculatorlD CalculatorlD Gets or setsthe ID for 
this calculator. 


DiscountsAndSurcharges DiscountsAndSurcharge Gets or setsa 
Collection referenceto a 

collection of discounts 
and surcharges 
objects. 

DisplayFormat string Gets or setsa string 
that representsthe 
format that is used 
when displaying 
prices. 


ExtraServiceElements ExtraServiceElementCollection | Gets or setsa 
referenceto a 





collection of extra 
service elements 
objects. 
FootNotes TextWithLinksCollection Gets or setsa 
collection of 
footnotes. 


Gets or setsif this 
calculator uses cubic 
pricing. 


IsDimensionalWeightRequired Gets or setsif this 
calculator requires 

NE dimensional weights. 

E 


IsCubicPricing 


Gets or setsif this 
calculator requiresthe 
Zone. 


MailServicelD MailServicelD Gets or setsthe ID of 
the associated mail 
service. 


PriceType string Gets or setsthe price 
type of the calculator. 
Values: 
R = Retail 
CB = Comm. Base 
CP = Comm. Plus 
NA = Not Applicable 


Title TextWithLinks Gets or sets the title of 
this calculator. 


Weightinfo Weightinformation Gets or setsa 
reference to the 
weightinformation 
associated with this 
calculator. 





2.3 CalculatorCollection Class 


2.3.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.3.2 Base Class 


List<Calculator> 


2.4 CalculatorElement Class 


2.4.1 Namespace 
ManTech.Usps.RateEngine .Business.Entity 


2.4.2 Base Class 


None 


2.4.3 Constructors 


public CalculatorElement() 


public CalculatorElement(CalculatorElement calculatorElement) 


2.4.4 Properties 


NETAS Type Description 
DataTablePieceColumn string Gets or setsthe Data Table 
TT IR econ 
DataTablePoundColumn string Gets or sets Data Table used 
PE a 


DestinationEntries DestinationEntryCollection Gets or sets a reference to a 
collection of destination 
entries. 


ElementType ElementTypes Gets or setsthe element 

AAA ie 
CalculatorElementID Gets or sets the ID for this 

e ETS 


IsDiscountElement Gets or setsif the element 


is a discount element. 
Discount elements are rows 
that the input fields are 
discounts to the total 


postage. 


IsPricingElement Gets if the elementis one of 
the price types. 


IsTitleElement Gets or sets if this element 
is a title element. Title 
elements are rows that 
contain only a title and have 
no input fields. 


NumberOf1 ulong Gets or sets the number of 
pieces fieldone. 





NumberOf2 ulong Gets or sets the number of 
A O AA 


PoundPrice decimal Gets or setsthe pound price 
fieldone. 

PoundPrice2 decimal Gets or setsthe pound price 
fieldtwo. 


SelectedDestinationEntry | DestinationEntry Gets the selected 
AA, me 
SelectedDestinationEntry | DestinationEntry.EntryValue | Gets or setsthe value of the 
eege ege 


Weight1 Decimal Gets or sets the weight 
be A 
Weight2 Decimal Gets or sets the weight 
OT eee 


2.4.5 CalculatorElement.ElementTypes Enumeration 





Name Value Description 


Unknown The elementtypeisunknown 
ZonePriceElement The elementis a zone price element 
NonZonePriceElement The elementis a non-zone price element 





2.4.6 SelectDestinationEntryValue Method 


Description 
This method is used to select a destination entry by passing the string value of the 
enumerator. 


Syntax 
publicvoid SelectDestinationEntryValue(string entryValueString) 


Parameters 
entryValueString 
Type: string 
Namespace: none 


Return Value 
None 


2.5 CalculatorElementCollection Class 


2.5.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.5.2 Base Class 


List<CalculatorElement> 


2.5.3 AddDestinationEntry Method 


Description 
This method is used to add a destination entry by passing the destination entry and the 
calculator element ID. 


Syntax 
publicvoid AddDestinationEntry( 
DestinationEntry destinationEntry, CalculatorElementID calculatorElementID 


) 


Parameters 
destinationEntry 

Type: DestinationEntry 

Namespace: Mantech.Usps.RateEngine.Business.Entity 
calulatorElementID 

Type: CalculatorElementID 

Namespace: Mantech.Usps.RateEngine.Business.Entity 


Return Value 
None 


2.5.4 FindByCalculatorElementiD Method 


Description 
This methodis used to find a Calculator Elementina collection by passingthe calculator 
element ID. 


Syntax 
publicvoid FindByCalculatorElementID (CalculatorElementID calculatorElementID) 


Parameters 
calulatorElementID 
Type: CalculatorElementID 
Namespace: Mantech.Usps.RateEngine.Business.Entity 


Return Value 
CalculatorElement 
Namespace: Mantech.Usps.RateEngine.Business.Entity 


2.6 CalculatorElementColumn Class 


2.6.1 Namespace 


ManTech.Usps.RateEngine.Domestic.Business.Entity 


2.6.2 Base Class 


None 


2.6.3 Properties 


NE Tate Type Description 


DisplayFormat Gets or sets the format to display data in this column 


FieldName string Gets or sets the name of the fieldin the Calculator 
object that is associated with this column. 


HeaderText Gets or sets the header text for this column 


HelpLink TextWithLinks | Gets or sets a reference to the help link information 
for this column. 


TypeOf ColumnType | Gets or sets the type of this column. 





2.6.4 CalculatorElementColumn.ColumnType Enumeration 


Name Value Description 


Each row in this column has a label. 
Each row in this column has an input text box 


DestinationEntry | 3 Each row in this column has a drop down with destination 
entry to selectfrom. 
Each row inthis column has a label that is formatted as a 
price. 


FeeLabel Each row in this column has a label for the fee 
| FeeTextBox |6 | Each row inthis column has an input text box for the fee 


7 Each row in this column has a label that is formatted as a fee 
price. 





2.7 CalculatorElementColumnCollection Class 


2.7.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.7.2 Base Class 


List<CalculatorElementColumn> 


2.8 CalculatorElementiD Structure 


2.8.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.8.2 Base Class 


None 


2.8.3 Constructors 


public CalculatorElementID(shortid) 


public CalculatorElementID(stringidString) 


2.8.4 Properties 


NET IS Type Description 


Empty (static) | CalculatorElementID | Gets an empty ID. 





Gets or setsthe ID as a short. 


2.8.5 ToShort Method 


Description 
This method is used to get the id represented as a short. 


Syntax 
publicshort ToShort() 


Parameters 
None 


Return Value 
Type: short 
Namespace: none 
The ID as a short. 


2.9 CalculatorlD Structure 


2.9.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.9.2 Base Class 


None 


2.9.3 Constructors 
public CalculatorlD(short id) 


publicCalculatorlD(stringidString) 


2.9.4 Properties 


Name Type Description 


Empty (static) | CalculatorlD Gets an empty ID. 
Gets or setsthe ID as a short. 





2.9.5 ToShort Method 


Description 
This method is used to get the id represented as a short. 


Syntax 
publicshort ToShort() 


Parameters 
None 


Return Value 
Type: short 
Namespace: none 
The ID as a short. 


2.10 CalculatorSet Class 


2.10.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.10.2 Base Class 


None 


2.10.3 Properties 


Description 
Calculator Gets or setsa Calculator object at the 
specifiedindex. 


Items CalculatorCollection Gets or sets a reference to a collection of 
Calculator objects. 


RelatedLinks | TextWithLinkCollection | Gets or setsa reference to a collection of 
related links. 


Gets or setsthe title. 





2.11 DestinationEntry Class 


2.11.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.11.2 Base Class 


None 


2.11.3 Constructors 
public DestinationEntry() 


public DestinationEntry(DestinationEntry destinationEntry) 


2.11.4 Properties 


Name Type Description 


EntryValue | Gets or sets the Id of the destination entry. 


IsSelected [bool — Gets or sets if this destination entry is selected. 
Label Gets the label. 





2.11.5 DestinationEntry.EntryValue Enumeration 


Name Value Description 


Unknown The Destination Entry is not known. This value servesas the 
default and represents that the values has not been set. 


None No Destination Entry. 


DNDC 2 The Destination Entry is DBMC. The value DNDC is the older 
SS 
[pou | 





2.12 DestinationEntryCollection Class 


2.12.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.12.2 Base Class 


List<DestinationEntry> 


2.12.3 Constructors 


public DestinationEntryCollection() 
public DestinationEntryCollection(int capacity) 


public DestinationEntryCollection(DestinationEntryCollection destinationEntries) 


2.13 DiscountsAndSurcharge Class 


2.13.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.13.2 Base Class 


None 


2.13.3 Properties 


Name Type Description 


Children DiscountsAndSurchargeCollection | Gets or setsa reference to a 
collection of discount or surcharge 
associated as children to this 
discount or surcharge. 

Cost decimal Gets or sets the cost of this 
discount or surcharge. 


GroupName string Gets or setsthe name of the group 
| this discount or surcharge belongs 
to. 
id short, S| Getsor seets thee ID. 


DiscountsAndSurchargeRefID Gets or setsthe reference ID. The 
reference ID is used to associate 
the discount or surcharge to 
description text and link URLs. 
TextWithLinks | TextWithLinks Gets or setsa reference toa 
TextWithLinks object that contains 
description text and link URLs. 
DiscountsAndSurchargeType Gets or sets the type of control 
used to represent the discount or 
surcharge. See table 2.15.4. 








2.13.4 DiscountsAndSurcharge.DiscountsAndSurchargeType Enumeration 


Name Value Description 


CheckBox 1 The discount or surcharge is Boolean and can be selected or 
unselected. 


RadioButton 2 The discount or surcharge is Boolean and when selected other 
discount or surcharges inthe same group cannot be. The 
graphical control appears radio button. 


RadioCheckBox | 3 The discount or surcharge is Boolean and when selected other 
discount or surcharges inthe same group cannot be. The 





|| graphical control appears check box. 


2.14 DiscountsAndSurchargeCollection Class 


2.14.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.14.2 Base Class 


List<DiscountsAndSurcharge> 


2.14.3 AddsAsChildTo Method 


Description 
This method is used to add to the collectionas a child of a parent with the parent ID. 


Syntax 
publicvoid AddAsChildTo( 
DiscountsAndSurcharge discountsAndSurcharge, short parentID 


) 


Parameters 
discountsAndSurcharge 

Type: DiscountsAndSurcharge 

Namespace: ManTech.Usps.Rate Engine. Business. Entity 
parentID 

Type: short 

Namespace: None 


Return Value 
None 


2.14.4 ContainsByReflD Method 


Description 
This method is used to see if the collection contains a discount and surcharge with the 
specified ref id. 


Syntax 

public bool ContainsByReflD( 
DiscountsAndSurchargeReflD reflD 

) 


Parameters 
refID 
Type: DiscountsAndSurchargeRefID 
Namespace: ManTech.Usps.RateEngine.Business.Entity 


Return Value 
Type: bool 
Namespace: none 


2.14.5 FindByReflD Method 


Description 
This methodis used to find the discounts and surcharge in the collection withthe 
specified ref id. 


Syntax 
public DiscountsAndSurcharge FindByReflD( 
DiscountsAndSurchargeReflD reflD 


) 


Parameters 
refID 
Type: DiscountsAndSurchargeReflD 
Namespace: ManTech.Usps.RateEngine.Business.Entity 


Return Value 
Type: DiscountsAndSurcharge 
Namespace: Mantech. Usps.Rate Engine. Business Entity 


2.15 DiscountsAndSurchargeReflD Structure 


2.15.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.15.2 Base Class 


None 


2.15.3 Constructors 
public DiscountsAndSurchargeRefID(short id) 


public DiscountsAndSurchargeRefID (stringidString) 


2.15.4 Properties 
NE Tate Type 


Empty (static) | CalculatorlD 













Description 
Gets an empty ID. 
Gets or setsthe ID as a short. 






2.15.5 ToShort Method 


Description 
This method is used to get the id represented as a short. 


Syntax 
publicshort ToShort() 


Parameters 
None 


Return Value 
Type: short 
Namespace: none 
The ID as a short. 


2.16 ErrorMessageDictionary Class 


2.16.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.16.2 Base Class 


Dictionary<int, string> 


2.16.3 message Static Property 


Description 
This method is used to access the error messages. 


Syntax 
publicstatic ErrorMessageDictionary message 


2.17 ExtraServiceElement Class 


2.17.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.17.2 Base Class 


ManTech.Usps.RateEngine.Business.Entity.ExtraService 


2.17.3 Constructors 


public ExtraServiceElement(ExtraServiceElement extraServiceElement) 


public ExtraServiceElement(ExtraServiceElement extraServiceElement, bool 
copyAdditionalFields) 


2.17.4 Properties 


Name Type Description 


NumberofPieces Gets or sets the number of pieces. 
TextWithLinksCollection 





2.18 ExtraServiceElementCollection Class 


2.18.1 Namespace 
ManTech.Usps.RateEngine.Business.Entity 


2.18.2 Base Class 


List<ExtraServiceElement> 


2.18.3 FindByExtraServicelD Method 


Description 
This method is used to find the extra service element by the extraservice ID. 


Syntax 
public ExtraServiceElement FindByExtraServicel D( 
ExtraServicelDextraServicelD 


) 


Parameters 
extraServicelD 
Type: ExtraServicelD 
Namespace: ManTech.Usps.RateEngine.Business.Entity 


Return Value 
Type: ExtraServiceElement 
Namespace: ManTech.Usps.RateEngine.Business.Entity 


2.19 Weightinformation Class 


2.19.1 Namespace 


ManTech.Usps.RateEngine.Business.Entity 


2.19.2 Base Class 


None 


2.19.3 Properties 


IsSinglePiece UnitsChangable 


SinglePieceUnits 


WeightLimit 


WeightLimitOperator 


WeightLimitText 


WeightMin 


WeightMinOperator 


Weight.WeightUnit 


Weight.WeightOperator 


TextWithLinks 


Weight.WeightOperator 





Description 

Gets or setsif the units can be 
changed by the user. 

Gets or setsan enumerator 
that is used as the default 
units (ounces or pounds) for 
this weight object. 

Gets or setsa referencetoa 
Weight object that represents 
the maximum weight limit. 
Gets or setsan enumerator 
that is used to determine how 
the maximum weightis 
applied. 

Gets or setsa reference to a 
TextWithLinks object that 
contains the description text 
and link URLs that represents 
the maximum weightlimit. 
Gets or setsa referenceto a 
Weight objectthat represents 
the minimum weight limit. 
Gets or setsan enumerator 
that isused to determine how 
the minimum weight is 
applied. 


3 Document Control 


3.1 Amendment List 
8/20/2014 | Multiple | Updated contract information and other 


Sections | sectionsto reflex the Sept 2014 Price 
Change 





James Fleeson 


